--..5....0....5....0....5....0....5....0....5....0....5....0....5....0..
--
--
--   Instructions for Scheduling
--   Spotlight for OS/390 Recordings
--
-- Spotlight for OS/390 Recordings of subsystem activity can be
-- scheduled using SQL insert statements.  For these insert 
-- statements to start a recording, no Spotlight client is required, 
-- but the Spotlight agent must be running.  While this is a
-- relatively simple procedure, great care should be taken when
-- choosing the values to insert into the recording log table.
-- The Spotlight for OS/390 client automatically validates all the
-- data that is used for a recording, and that validation process
-- must be done by hand when writing insert statements outside of
-- the client.
--
-- Columns in the recording log table:
--  RECORDING_OWNER     User ID of the initiator of the recording
--  RECORDING_NAME      Name of the recording
--  RECORDING_DESC      Description of the recording
--  RECORDING_STATUS    Status of the recording
--  RECORDING_RET_CODE  Return code from a completed recording
--  REFRESH_RATE_FG     Foreground sample rate in seconds
--  REFRESH_RATE_BG     Background sample rate in seconds
--  START_TIME_SCHED    Scheduled start time
--  END_TIME_SCHED      Scheduled end time
--  REQUESTED_SAMPLES   Requested samples
--  SAMPLE_COUNT        Actual samples taken
--  RECORDING_SIZE_REQ - Requested recording size in bytes
--  RECORDING_SIZE_ACT  Actual recording size in bytes
--  RECORDING_OPTIONS   Miscellaneous option fields
--
--..5....0....5....0....5....0....5....0....5....0....5....0....5....0..
-- Values for the insert:
--  RECORDING_OWNER    - Character data, Capital letters, No spaces
--  RECORDING_NAME      Character data, Capital letters, No spaces
--  RECORDING_DESC      Character data
--  RECORDING_STATUS   - Must be 'U' for unscheduled
--  RECORDING_RET_CODE  Must be initialized to zero
--  REFRESH_RATE_FG     Integer data from 1 to 2,147,483,647
--  REFRESH_RATE_BG    - Must be initialized to zero
--  START_TIME_SCHED    Any valid timestamp value
--  END_TIME_SCHED      Any valid timestamp value > START_TIME_SCHED
--  REQUESTED_SAMPLES  - Integer data from 1 to 2,147,483,647
--  SAMPLE_COUNT       - Must be initialized to zero
--  RECORDING_SIZE_REQ - Integer data from 1 to 2,147,483,647
--  RECORDING_SIZE_ACT - Must be initialized to zero
--  RECORDING_OPTIONS  - Must be 'N' for no wrap around

-- Example:
--INSERT                         
--INTO QUEST.QCRECORD_LOG_0300   
--  (                            
--  RECORDING_OWNER   ,          
--  RECORDING_NAME    ,          
--  RECORDING_DESC    ,          
--  RECORDING_STATUS  ,          
--  RECORDING_RET_CODE ,         
--  REFRESH_RATE_FG ,            
--  REFRESH_RATE_BG   ,          
--  START_TIME_SCHED ,           
--  END_TIME_SCHED ,             
--  REQUESTED_SAMPLES ,          
--  SAMPLE_COUNT      ,          
--  RECORDING_SIZE_REQ,          
--  RECORDING_SIZE_ACT,          
--  RECORDING_OPTIONS            
--  )                            
--VALUES                         
--  (                            
--  'USERID' ,          
--  'RECORDINGNAME',                
--  'Description',      
--  'U' ,          
--  0,          
--  10,          
--  0,          
--  CURRENT_TIMESTAMP ,          
--  (CURRENT_TIMESTAMP + 1 HOUR),
--  100,          
--  0,          
--  2147483647,          
--  0,          
--  'N'                          
--  )                            
--  ;                            
